3D Graphics Programming with QuickDraw 3D 1.5.4

Adding and Subtracting Vectors

QuickDraw 3D provides routines that you can use to add a vector to a vector or to subtract a vector from a vector.

Q3Vector2D_Add

You can use the Q3Vector2D_Add function to add two two-dimensional vectors.



 
TQ3Vector2D *Q3Vector2D_Add (

                     const TQ3Vector2D *v1, 

                     const TQ3Vector2D *v2, 

                     TQ3Vector2D *result);

v1: A two-dimensional vector.
v2: A two-dimensional vector.
result: On exit, the sum of v1 and v2 .

DESCRIPTION

The Q3Vector2D_Add function returns, as its function result and in the result parameter, the two-dimensional vector that is the sum of the two vectors v1 and v2 . Note that on entry the result parameter can be the same as either v1 or v2 (or both).

Q3Vector3D_Add

You can use the Q3Vector3D_Add function to add two three-dimensional vectors.



 
TQ3Vector3D *Q3Vector3D_Add (

                     const TQ3Vector3D *v1, 

                     const TQ3Vector3D *v2, 

                     TQ3Vector3D *result);

v1: A three-dimensional vector.
v2: A three-dimensional vector.
result: On exit, the sum of v1 and v2 .

DESCRIPTION

The Q3Vector3D_Add function returns, as its function result and in the result parameter, the three-dimensional vector that is the sum of the two vectors v1 and v2 . Note that on entry the result parameter can be the same as either v1 or v2 (or both).

Q3Vector2D_Subtract

You can use the Q3Vector2D_Subtract function to subtract a two-dimensional vector from a two-dimensional vector.



 
TQ3Vector2D *Q3Vector2D_Subtract (

                     const TQ3Vector2D *v1, 

                     const TQ3Vector2D *v2, 

                     TQ3Vector2D *result);

v1: A two-dimensional vector.
v2: A two-dimensional vector.
result: On exit, the result of subtracting v2 from v1 .

DESCRIPTION

The Q3Vector2D_Subtract function returns, as its function result and in the result parameter, the two-dimensional vector that is the result of subtracting vector v2 from vector v1 . Note that on entry the result parameter can be the same as either v1 or v2 (or both).

Q3Vector3D_Subtract

You can use the Q3Vector3D_Subtract function to subtract a three-dimensional vector from a three-dimensional vector.



 
TQ3Vector3D *Q3Vector3D_Subtract (

                     const TQ3Vector3D *v1, 

                     const TQ3Vector3D *v2, 

                     TQ3Vector3D *result);

v1: A three-dimensional vector.
v2: A three-dimensional vector.
result: On exit, the result of subtracting v2 from v1 .

DESCRIPTION

The Q3Vector3D_Subtract function returns, as its function result and in the result parameter, the three-dimensional vector that is the result of subtracting vector v2 from vector v1 . Note that on entry the result parameter can be the same as either v1 or v2 (or both).